home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / tbag21.zip / TBAG.DOC < prev    next >
Text File  |  1991-02-04  |  16KB  |  514 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                 TBAG.EXE
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                            Author : Steve Thompson
  21.                            GT Net Address : 302/006
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.                        Version 2.1 - 14th February 1991
  40.  
  41.                                GT16 specific
  42.                   Do not use this version of Tbag with GT15
  43.  
  44.  
  45.  
  46.     DISCLAIMER / COPYRIGHT 
  47.  
  48.     This program comes with no warranty, either express or implied.
  49.     Use it at your own risk.
  50.  
  51.     These programs and documentation ARE NOT placed in the public domain
  52.     and the copyright remains with the author.   However, please feel
  53.     free to share copies of these programs and documentation with anyone
  54.     provided that :
  55.  
  56.     1) the EXE and DOC files are unmodified and distributed together and
  57.  
  58.     2) no fee is charged for copying or distribution.
  59.  
  60.  
  61.  
  62.     ┌─  Registration  ──────────────────────────────────────────────────┐
  63.     │                                                                   │
  64.     │  This program does not require registration in the normal sense.  │
  65.     │  There's no money involved, you don't need a crc to run it, etc,  │
  66.     │  etc. All I ask is that, if you're using the program, I'd like to │
  67.     │  know about it.   There's an easy way.   From dos, just run :     │
  68.     │                                                                   │
  69.     │      TBAG REGISTER                                                │
  70.     │                                                                   │
  71.     │  It will then send me a netmail message noting that you're        │
  72.     │  using the program.   Easy, no cash, no pain, no strain.          │
  73.     │                                                                   │
  74.     └───────────────────────────────────────────────────────────────────┘
  75.  
  76.  
  77.     On the other hand, if you're absolutely overwhelmed with
  78.     generosity, you can send donations (in Australian dollars) to :
  79.  
  80.     Steve Thompson
  81.     PO Box E64
  82.     Parramatta East  NSW  2150
  83.     Australia
  84.  
  85.  
  86.  
  87.    PURPOSE
  88.  
  89.    Tbag is designed to give the individual sysop information about and
  90.    the control over their own echomail routings.   Using Tbag reports,
  91.    you can see where your echomail Q or E bags come from and each system
  92.    that they pass through.   You can also see if upstream nodes are
  93.    crashable, what speed modem they use, in which city they're located
  94.    and if there are any warnings such as 'temp_down'.   The Tbag report
  95.    will also show which day the Tbag passed through each system so that
  96.    you can spot any delays in the mail.   From this, you can tell if
  97.    there is a more efficient or cost-effective routing for any and all
  98.    conferences. You also see the upstream routing of B bags in each
  99.    conference to check that it's the reverse of downstream routing.
  100.  
  101.    Each system that sponsors one or more conferences, will generate a T
  102.    bag for each sponsored conference automatically twice a month, on the
  103.    1st and the 16th.   T bags may also be generated manually by the
  104.    sponsor.
  105.  
  106.    As it passes down the chain, each system will unpack the T bag,
  107.    append their own routing information and then repack all of the T
  108.    bags for each of their downstream nodes.   While the T bag is
  109.    unpacked, it is distributed to the corresponding message area on your
  110.    system.
  111.  
  112.  
  113.    Here's a sample of the report you should get in each conference for
  114.    which the sponsor is generating T bags (and all intermediate systems
  115.    are running Tbag).
  116.  
  117.  
  118.    Echomail routing report generated by TBAG
  119.  
  120.    E10/053  Oz Companions
  121.  
  122.    302/001 96 C Sydney (Sponsor) E1136
  123.       ║
  124.       ╟─── 302/003 96 C T Sydney
  125.       ║
  126.    302/000 96 C Sydney E1137   302/001
  127.       ║
  128.       ╟─── 004/005 96 C   Dallas
  129.       ╟─── 302/016 24 C T Sydney
  130.       ╟─── 302/017 24     Sydney
  131.       ╟─── 307/001 96 C   Brisbane
  132.       ║
  133.    302/006 24 C Sydney E1137   302/000
  134.       ║
  135.       ╟─── 302/011 24   T Sydney
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.    SETTING UP
  143.  
  144.    Using Tbag depends upon a couple of things.
  145.  
  146.    1 - You must be using GT16,  (if you're using GT15, use V1.1 of Tbag)
  147.  
  148.    2 - You must be receiving and sending G bags,
  149.  
  150.    3 - You must be using pkzip for G bags,
  151.        (doesn't matter what you use for B, E or Q bags)
  152.  
  153.  
  154.    Place TBAG.EXE anywhere in your Dos path.
  155.  
  156.    Next, make a subdirectory \TBAGOUT on you mail drive.   The mail
  157.    drive is the one which has the \MAILOUT \MAILIN and \MAILWORK
  158.    subdirectories.
  159.  
  160.    In \TBAGOUT, make up a text file called TBAG.CTL
  161.    In this file list each system which is downstream from you and that
  162.    you connect with and THAT IS RUNNING TBAG.   See the list of
  163.    questions below.
  164.  
  165.    The net/node number must start in column 1.
  166.    You can just copy lines out of the nodelist like so :
  167.  
  168.    302/000 02-804-6412  96 Sydney     *Poet's Dilemma       John Della-Torre
  169.    302/011 02-455-1806  24 Sydney     *Home Computing       David Woodbridge
  170.    302/016 02-671-5538  24 Sydney     *Koala Country        Warren Leadbeatter
  171.  
  172.  
  173.  
  174.      * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  175.      *                                                               *
  176.      *                  I M P O R T A N T   N O T E                  *
  177.      *                                                               *
  178.      *   DO NOT ADD TO THIS FILE ANY DOWNSTREAM SYSTEM IF YOU        *
  179.      *   ARE NOT ABSOLUTELY CERTAIN THAT THEY ARE RUNNING TBAG.      *
  180.      *                                                               *
  181.      *   If they're not running Tbag, then the T bags that you       *
  182.      *   send them will be unpacked by Mdist and they will build     *
  183.      *   up in their mailout and mailin subdirectories, eventually   *
  184.      *   bringing that downstream system to a grinding halt.         *
  185.      *                                                               *
  186.      *   No way around this one.  Mdist unpacks everything in a      *
  187.      *   G bag, not just Q, E and B bags.                            *
  188.      *                                                               *
  189.      *                 You have been warned!                         *
  190.      *                                                               *
  191.      * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.    Here is an example of a few Tbag.ctl files.  Let's assume that only
  199.    four systems are running Tbag.
  200.  
  201.                                                 tbag.ctl
  202.                         302/000 sponsor         302/006
  203.                            
  204.                           │ │
  205.             ──────────────┘ │
  206.     Other                   │
  207.    systems                                     tbag.ctl
  208.     not                  302/006                302/000
  209.    running                                   302/011
  210.     tbag    ──────────────┘ │ │                 302/016
  211.                             │ │
  212.                             │ │
  213.                   ┌─────────┘ └───────────┐
  214.                   │                       │
  215.                                                          tbag.ctl
  216.                302/011                 302/016 sponsor    302/006
  217.                No tbag.ctl
  218.  
  219.  
  220.  
  221.    Ask yourself these questions before you add any system to the
  222.    TBAG.CTL file :
  223.  
  224.    1 - Do I have a direct connect with this system?
  225.  
  226.    2 - Am I passing G bags to this system?
  227.  
  228.    3 - Are these G bags 'zipped'?
  229.  
  230.    4 - Am I passing E or Q bags DOWNSTREAM in these G bags?
  231.  
  232.    5 - Is the other system running Tbag?   (Ask the sysop, don't assume)
  233.  
  234.  
  235.    If the answer to all of these questions is Yes, then you can add that
  236.    system to your TBAG.CTL file.
  237.  
  238.    If the answer to ANY question is No, don't.
  239.  
  240.  
  241.  
  242.  
  243.    If you sponsor one or more conferences, add the following to the
  244.    start of your netmail.bat file so that it runs once per day, before
  245.    your first Mbag in mail time :
  246.  
  247.    TBAG GEN
  248.  
  249.  
  250.    If you pass conferences to downstream nodes, put the following AFTER
  251.    EVERY run of Mbag :
  252.  
  253.    TBAG BAG
  254.  
  255.  
  256.    Everyone, run the following BEFORE EVERY run of Mdist :
  257.  
  258.    TBAG DIST
  259.  
  260.  
  261.  
  262.    This means that you should modify all netmail batch files, such as :
  263.  
  264.    NETMAIL.BAT
  265.    G_UNPAK.BAT
  266.    GTCRASH.BAT
  267.    CRASHOUT.BAT
  268.    etc.
  269.  
  270.    If you don't run TBAG BAG after every MBAG and TBAG DIST before every
  271.    MDIST, you'll lose T bags.
  272.  
  273.    Note that you should put TBAG in the batch file so that it runs on
  274.    your mail drive.
  275.  
  276.  
  277.    In summary,
  278.    If you sponsor conferences, you should run :
  279.  
  280.    TBAG GEN     once a day, at the start of netmail
  281.    TBAG BAG     after every mbag
  282.    TBAG DIST    before every mdist
  283.  
  284.  
  285.    If you pass conferences downstream but don't sponsor any, run :
  286.  
  287.    TBAG BAG     after every mbag
  288.    TBAG DIST    before every mdist
  289.  
  290.  
  291.    If you don't sponsor and don't pass downstream, just run :
  292.  
  293.    TBAG DIST    before every mdist
  294.  
  295.  
  296.  
  297.    By the way, here's how I have things set up on my system.   For
  298.    clarity, I've taken out all the other miscellaneous programs and just
  299.    shown Tbag and the mail programs.
  300.  
  301.    netmail.bat   (runs at 4:30am)
  302.      D:                          <--- mail drive
  303.      CD \
  304.      TBAG GEN
  305.      MBAG
  306.      TBAG BAG
  307.      MDRIV        --------------->  g_unpak.bat   (after each connect)
  308.      TBAG DIST                      TBAG DIST
  309.      MDIST                          MDIST /G
  310.                                     MBAG /G
  311.                                     TBAG BAG
  312.  
  313.  
  314.  
  315.  
  316.  
  317.    Next comes your routing file(s).
  318.  
  319.    . If all of your ROUTING INSTRUCTIONS and MESSAGE DISTRIBUTION are in
  320.      ROUTING.BBS, do nothing
  321.  
  322.    . If your ROUTING INSTRUCTIONS and MESSAGE DISTRIBUTION are together
  323.      but not in ROUTING.BBS, add something like  /R:MYROUT.BBS to the
  324.      Tbag command line.   In this case, all of the ROUTING INSTRUCTIONS
  325.      and MESSAGE DISTRIBUTION would be in MYROUT.BBS
  326.  
  327.    . If your ROUTING INSTRUCTIONS and MESSAGE DISTRIBUTION are in
  328.      different files, add something like  /R:MYROUT.BBS /M:MYDIST.BBS to
  329.      the Tbag command line.   In this case, all of the ROUTING
  330.      INSTRUCTIONS would be in MYROUT.BBS and all of the MESSAGE
  331.      DISTRIBUTION would be in MYDIST.BBS
  332.  
  333.      For example,
  334.  
  335.      TBAG GEN /R:MYROUT.BBS /M:MYDIST.BBS
  336.      TBAG BAG /R:MYROUT.BBS /M:MYDIST.BBS
  337.      TBAG DIST /R:MYROUT.BBS /M:MYDIST.BBS
  338.  
  339.    Make sure that you add these (if needed) to all occurances of TBAG in
  340.    every batch file.
  341.  
  342.    The GEN, BAG or DIST parameter must be first on the command line.
  343.    All other parameters may be in any order.
  344.  
  345.  
  346.  
  347.    Removing Extended Graphics Characters
  348.  
  349.    This is for those who have printers or speech synthesisers that don't
  350.    handle extended characters too well.   Add XOFF to the Tbag command
  351.    line.  This will convert any extended graphics characters to
  352.    printable characters before distributing tbags to message areas.   It
  353.    doesn't affect the downstream T bag.
  354.    It's only necessary on the GEN or DIST command lines, like so :
  355.  
  356.    TBAG GEN XOFF
  357.    TBAG DIST XOFF
  358.  
  359.  
  360.  
  361.    Once you're set for Tbagging, ask the sysop(s) of the upstream
  362.    system(s) to add you to his/her/their TBAG.CTL file(s).   Now sit
  363.    back and wait for T bags to come your way.
  364.  
  365.  
  366.  
  367.  
  368.  
  369.    REPORTS
  370.  
  371.    Tbag will distribute its report for each conference to the
  372.    corresponding message area on your system.   If there are any
  373.    conferences that are 'skipped' in your message distribution, the Tbag
  374.    report will be distributed to your first netmail message area.
  375.  
  376.    Here is a sample of a Tbag report and a brief explanation of a couple
  377.    of the fields :
  378.  
  379.  
  380.    Echomail routing report generated by TBAG
  381.  
  382.    E10/053  Oz Companions
  383.  
  384.    302/001 96 C Sydney (Sponsor) E1136
  385.       ║
  386.       ╟─── 302/003 96 C T Sydney
  387.       ║
  388.    302/000 96 C Sydney E1137   302/001
  389.       ║
  390.       ╟─── 004/005 96 C   Dallas
  391.       ╟─── 302/006 24 C T Sydney
  392.       ╟─── 302/016 24 C T Sydney
  393.       ╟─── 302/017 24     Sydney      **TEMP_DOWN**
  394.       ╟─── 307/001 96 C   Brisbane
  395.  
  396.  
  397.    C  means that the system is crashable (from the nodelist)
  398.  
  399.    T  means that T bags are being sent to that downstream node.  This is
  400.       no guarantee that the downstream nodes is actually running Tbag.
  401.       Check with the sysop before sending T bags.
  402.  
  403.     302/001  means that 302/000 is sending upstream B bags in this
  404.               conference to 302/001.   This gives you a method of making
  405.               sure that upstream routing is a reverse of downstream
  406.               routing.
  407.  
  408.    **  Any warnings in the nodelist against downstream nodes (such as
  409.        temp_down) will also be shown.
  410.  
  411.  
  412.  
  413.    Note that T bags piggyback on G bags.   The netmail software (Mbag,
  414.    Mdriv and Mdist) doesn't know anything about T bags.   This means
  415.    that you should not change the message header of a Tbag report to
  416.    'unbagged' in the expectation that it will continue downstream as a T
  417.    bag.   It will just be bagged like the normal message file that it
  418.    now is and will handled like any other message by the mail software.
  419.  
  420.  
  421.  
  422.  
  423.    MANUAL GENERATION OF T BAGS
  424.  
  425.    Tbag will automatically generate T bags for each conference on the
  426.    1st and 16th days of each month.
  427.  
  428.    If, on any other day of the month, you (the sponsor) want to manually
  429.    generate a T bag for one conference, enter a message in that
  430.    conference, addressed to 'Tbag Gen'.
  431.  
  432.    If, on any other day of the month, you (the sponsor) want to manually
  433.    generate T bags for all sponsored conferences, enter a message
  434.    addressed to 'Tbag Gen' in the first netmail area.
  435.  
  436.    This message may be marked private but don't mark it received or
  437.    bagged.   Tbag will take care of that when it runs.   The subject and
  438.    text of the message are not important in this release.
  439.  
  440.    If you're not the sponsor of a particular conference, don't enter a
  441.    message to Tbag Gen.   Only the sponsor of a conference may do so.
  442.    If you're not the sponsor, the message will just be bagged like any
  443.    other message and be sent on its way around the network.
  444.  
  445.  
  446.  
  447.    PROGRAM LIMITS
  448.  
  449.    At present, the limits of Tbag are :
  450.  
  451.       350 conferences
  452.       100 downstream connects
  453.    10,000 bytes in gconsol.ctl
  454.  
  455.    If any of these is insufficient, please let me know.
  456.  
  457.  
  458.  
  459.  
  460.    Appendix 1
  461.  
  462.    Acknowledgments
  463.  
  464.    Thanks to Bob Camp for his Turbo Pascal translation of the Toolkit.
  465.  
  466.  
  467.  
  468.  
  469.    Program History
  470.  
  471.    17-Feb-90   version 1.0  First release
  472.  
  473.    03-Mar-90   version 1.1  Corrected a bug in the calculation of the
  474.                             EchoDay.
  475.  
  476.    01-Oct-90   version 2.0  Changed to match GT16 (beta 01) .MES message
  477.                             file format.
  478.                             Tbag v2.0 is for GT16 systems
  479.                             Tbag v1.1 is for GT15 systems
  480.  
  481.    04-Feb-91   version 2.1  Increased limits on number of echos and size
  482.                             of gconsol.ctl file.
  483.                             Added registration option.
  484.  
  485.  
  486.  
  487.  
  488.  
  489.    Improvements to come; please feel free to make suggestions :
  490.  
  491.    1 - Improved support for $ include routing files (if anyone finds it
  492.        necessary.
  493.  
  494.    2 - Remote turning on/off of Tbags from the upstream connect.  Much
  495.        like the .QM and .QG messages.
  496.  
  497.    3 - When a Tbag reaches the end of a chain, automatically send the
  498.        report back to the sponsor.   Have to be careful with this one
  499.        that it doesn't cause an overload to the netmail system.
  500.  
  501.        (ps, been thinking about this one.  Can't think of any reliable
  502.        way to do it without overloading netmail.  Consider any of the
  503.        popular conferences; we could end up with over 200 netmail
  504.        messages heading back to the sponsor.) Anyhow, this program was
  505.        originally intended to allow Subscribing sysops to improve echo
  506.        routings.
  507.  
  508.    4 - A companion to allow sponsors to generate a routing map of their
  509.        conferences.   Only useful if 3 goes ahead.
  510.  
  511.  
  512.     
  513.  
  514.